home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / inter33b.zip / INTPRINT.DOC < prev    next >
Text File  |  1992-07-12  |  9KB  |  226 lines
  1.                 INTPRINT v2.20
  2.                             by Ralf Brown
  3.  
  4. The INTPRINT program is hereby donated to the public domain, with the sincere
  5. hope that proper credit will be retained in all copies and derivatives.
  6.  
  7. ------------------------------------------------------------------------------
  8.  
  9. INTPRINT.COM is a simple formatter for the interrupt list.  Use this
  10. program to print only a portion of the list, prevent widow lines at the
  11. beginning of a function call, number the pages, boldface key portions,
  12. center the printout, or create a summary of the function calls.  After
  13. formatting is complete, the total number of pages is displayed on the
  14. screen.
  15.  
  16. Usage:
  17.    intprint [options] intlist [[>|>>]outfile]
  18.  
  19. where the options are:
  20.         -b    boldface the title lines, Return:, and Notes: by overprinting
  21.         -B    boldface by sending printer control sequences
  22.  
  23.     -d    (duplex) print even/odd pages with different margins; suitable
  24.           for binding the printout.
  25.  
  26.         -e    assume printer is in elite mode (96 characters per line), and
  27.           indent the output eight spaces to center the printout.  This
  28.           is primarily for the default printer, as other printers may
  29.           force the equivalent or override this option.
  30.  
  31.         -ffile  create a file containing only the data structures described
  32.               in the interrupt list.
  33.           NOTE: you must put the filename immediately after the 'f'; no
  34.               blanks are allowed.
  35.  
  36.     -Ffile  filter the listing based on include and exclude strings
  37.           in 'file'.  Only entries whose headers match none of the
  38.           exclude strings and at least one of the include strings
  39.           will be processed.  All others will be skipped.
  40.           NOTE: you must put the filename immediately after the 'F'; no
  41.               blanks are allowed.
  42.  
  43.     -H    print a heading on each page indicating which interrupts
  44.           are listed on the page
  45.  
  46.         -iN   indent the output N spaces.  The output device is assumed to be
  47.               at least 80+N characters wide.
  48.           NOTE: you must put the number immediately after the 'i'; no
  49.               blanks are allowed.
  50.  
  51.     -I    assume the printer is capable of producing IBM character
  52.           graphics.  Printers other than "default" may force this option.
  53.  
  54.     -lN   print N lines per pages, overriding the printer-specific
  55.           default.
  56.     -LN   assume N lines on a page.  If this is more than the number of
  57.           lines to print on each page, INTPRINT will use line feeds to
  58.           advance to the next page instead of form feeds.
  59.  
  60.     -m    specify that the interrupt list is in multiple parts beginning
  61.           with the named file.  INTPRINT will increment the last
  62.           character of the name to get the next filename, and continue
  63.           until it is unable to open the file thus selected.
  64.  
  65.         -nN   assume N pages have already been printed, and start numbering
  66.               at N+1.  This option allows you to create a properly-numbered
  67.               printout even if there is not enough disk space to concatenate
  68.           the parts of the interrupt list or hold a complete output file.
  69.           See the examples below.
  70.           NOTE: you must put the number immediately after the 'n'; no
  71.               blanks are allowed.
  72.  
  73.         -p    print the page number at the bottom center of each page
  74.  
  75.     -Pname use control codes for the specified printer (-P? lists the
  76.           supported printers).  The printer name may be given in either
  77.           case and abbreviated to a unique prefix; use either dashes or
  78.           underscores in place of blanks in the printer name.
  79.  
  80.     -rN:M print only pages N through M.  The entire input is processed
  81.           for use in -s and -f summaries (see below) even though only
  82.           a portion is formatted for printing.  If filtering is enabled,
  83.           (see -F), page numbers are based on entries selected by the
  84.           filter file.
  85.           NOTE: you must put the page numbers immediately after the 'r';
  86.           no blanks are allowed.
  87.  
  88.         -sfile  create a one-line-per-function summary and write it to "file"
  89.               if -n is also given, the summary will be appended to "file",
  90.               allowing a properly numbered summary file to be created even if
  91.               there is not enough disk space to concatenate the parts of the
  92.               list.  See the examples below.
  93.           NOTE: you must put the filename immediately after the 's'; no
  94.               blanks are allowed.
  95.  
  96.     -tN   select typeface N for the chosen printer (currently supported
  97.           only for the HP).
  98.  
  99.     -wN   (widow lines) search N lines from the end of the page for a
  100.           good place to break.  The default is ten lines; the valid
  101.           range is from 3 to one-half of the page length.
  102.           NOTE: you must put the number immediately after the 'w'; no
  103.               blanks are allowed.
  104.  
  105. Options may not be combined; "-ep" is illegal and the "p" will be ignored.
  106.  
  107. The formatted result of the input file is sent to the specified output file,
  108. or to standard output if no output file is given.  Standard output may be
  109. redirected using the usual Unix or MSDOS redirection characters > or >>.  If
  110. you only want a summary file or data formats file, send or redirect the
  111. output to the null device ("NUL" under MSDOS, "/dev/null" under Unix).
  112.  
  113.  
  114. FILTER FILE:
  115. ------------
  116.  
  117. The filter file specified with -F is a simple text file containing
  118. include lines, exclude lines, and comment lines.  Include lines start
  119. with a plus sign (+) in the first column, followed immediately by the
  120. desired string; exclude lines start with a minus sign (-) in the first
  121. column, followed immediately by the desired string.  Comment lines
  122. start with a hash mark (#) in the first column and are ignored.
  123.  
  124. If a filter file is specified, only entries whose title lines contain
  125. at least one of the include lines (ignoring uppercase/lowercase
  126. distinctions) and none of the exclude lines are processed.  Thus, a
  127. filter file must contain at least one include line, or INTPRINT will
  128. skip all interrupt entries and print only the non-interrupt text in the
  129. file.
  130.  
  131. All spaces on include and exclude lines are significant.  Thus,
  132.     + DOS
  133. will only match entries containing the four-letter sequence " DOS",
  134. while
  135.     +DOS
  136. will match any entries containing the sequence "DOS", whether or not it
  137. is preceded by a blank.
  138.  
  139. ----cut here----
  140. # SAMPLE.FLT
  141. # Sample filtering file.  Extract MS-DOS calls, but exclude
  142. # DR-DOS-specific, DOS-extender, and non-DOS networking calls.
  143. # Note: a few extraneous calls are still included.
  144. #
  145. + DOS
  146. -DR DOS
  147. -DR-DOS
  148. -DR Multiuser DOS
  149. -Concurrent DOS
  150. -DOS/16M
  151. -DOS4GX
  152. -DOS/4G
  153. -extender
  154. -LAN Manager
  155. -DECnet DOS
  156. #
  157. # end of SAMPLE.FLT
  158. ----cut here----
  159.  
  160.  
  161. ------------------------------------------------------------------------------
  162.  
  163. EXAMPLES:
  164. ---------
  165.  
  166.         Print the interrupt list with page numbers, and create a summary file,
  167.     without concatenating INTERRUP.A, INTERRUP.B, and INTERRUP.C:
  168.  
  169.         A> intprint -sb:interrup.sum -p interrup.a >prn
  170.         116 pages.   [screen output from INTPRINT]
  171.         A> intprint -sb:interrup.sum -p -n116 interrup.b prn
  172.         261 pages.   [screen output from INTPRINT]
  173.         A> intprint -sb:interrup.sum -p -n261 interrup.c >prn
  174.         386 pages.   [screen output from INTPRINT]
  175.  
  176.     or, more easily:
  177.         A> intprint -sb:interrup.sum -m -p interrup.a prn
  178.         942 pages.   [screen output from INTPRINT]
  179.  
  180.         Create only a summary file:
  181.  
  182.         C> intprint -sinterrupt.sum interrup.lst nul
  183.  
  184.     Print only those entries containing the string "DOS", except
  185.     those containing the string "DR-DOS"
  186.  
  187.         C> type dos
  188.         +DOS
  189.         -DR-DOS
  190.  
  191.         C> intprint -Fdos interrup.lst nul
  192.         
  193.  
  194.         Print the interrupt list on an Epson FX80, using 54 lines per page and
  195.         omitting both page numbers and summary:
  196.  
  197.         C> intprint -Pepson -l54 interrup.lst >prn
  198.  
  199.     Print the interrupt list using 120 lines on every 132-line page (using
  200.     superscript mode, for example), and make divider lines using IBM
  201.     character graphics:
  202.  
  203.         C> intprint -I -l120 -L132 interrup.lst >prn
  204.  
  205.     Print only pages 123 through 127, assuming that 106 pages are contained
  206.     in the first section of the list:
  207.  
  208.         C> intprint -n106 -r123:127 interrup.b prn
  209.  
  210.     Print using HP PCL4/5 escape sequences, numbering pages, from file
  211.     "interrup.lst" to file "interrup.pcl", at the default 69 lines per
  212.     page, using form-feeds:
  213.  
  214.         C> intprint -Php -p interrup.lst >interrup.pcl
  215.         942 pages.   [screen output from INTPRINT]
  216.  
  217. ------------------------------------------------------------------------------
  218.  
  219. PORTABILITY:
  220. ------------
  221.  
  222. INTPRINT.C contains the source code for INTPRINT, for those people who are
  223. using the interrupt list on a machine which does not run MSDOS.  This code has
  224. been tested with Turbo C and Mach (BSD 4.3 Unix) "cc".
  225.  
  226.